home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 2000 March / macformat-088.iso / Shareware Plus / Graphics / PanoTools2.0b1 / Helpers / Readme PTStereo < prev    next >
Encoding:
Text File  |  2000-01-21  |  3.7 KB  |  132 lines  |  [TEXT/ttxt]
  1. Readme PTStereo 2.0b1
  2.  
  3.  
  4. Changes to version 0.1:
  5.  
  6. o Textures for texture mapping can be selected from
  7.   different images.
  8. o Front end 'PTPicker' added for simple 
  9.   triangulation.
  10. o Versioning has been adjusted to the
  11.   library file 'pano12.lib'.
  12.   
  13.   
  14. General:
  15. =======
  16.  
  17. PTStereo creates 3D-worlds from image pairs.
  18. Applications range from object movies to terrain 
  19. visualization. Any pair of images can be used 
  20. without alignment requirements. 3D-data can be
  21. extracted for any feature visible in both images,
  22. as long as the two images have different viewpoint
  23. (non-zero stereo base). 
  24.  
  25. User input involves the triangulation of both
  26. images: Corresponding feature points have to be 
  27. identified, and connected to a mesh consisting
  28. of triangles. The output of PTStereo is a 
  29. 3D-world ready to be viewed with any VRML-browser.
  30. This world consists of a texture mapped indexed face
  31. set. The second output is a log-file consisting of
  32. information regarding the quality of the numeric
  33. fit, and the calculated coordinates. The log-file
  34. itself can be used as input for further refinements
  35. and transformations.
  36.  
  37.  
  38. Installation:
  39. =============
  40.  
  41. The application 'PTStereo' requires the folder
  42. 'Templates' to be in the same directory. PTStereo
  43. uses the library 'pano12.lib', which either has
  44. to be in the same directory as 'PTStereo', or be
  45. dropped onto the system folder. Your system should 
  46. move it then to the extensions folder.
  47.  
  48.  
  49.  
  50. Using PTStereo:
  51. ===============
  52.  
  53. PTStereo should be used as helper for the
  54. frontend 'PTPicker'. Using PTPicker, a textfile
  55. is generated consisting of feature point coordinates
  56. and triangles. Download the file
  57. <http://www.fh-furtwangen.de/~dersch/examples.zip>.
  58. for an example.
  59.  
  60. More Uses:
  61. ==========
  62.  
  63. (1) The final Project file contains
  64. vertex coordinates in Meshwork syntax. These
  65. can be cut and pasted into mesh file to
  66. generate a 3D-mesh for editing in Meshwork.
  67.  
  68. (2) The final Project file contains
  69. commands ('o'-lines) for Panorama Tools:
  70. Execute these lines in the adjust-submenu
  71. (mode 'insert', 'use script') and the images
  72. texture0.jpg and texture1.jpg are transformed
  73. to have parallel film planes. They can then
  74. be used for view interpolation  with any
  75. Morphing software, or for stereo viewing.
  76.  
  77.  
  78. How it works:
  79. =============
  80.  
  81. To extract depth data from stereo images,
  82. careful alignment of the images is usually
  83. reqired: The images must have parallel film
  84. planes to directly apply the stereo equations.
  85. The nontrivial part of this program is the
  86. perspective change to achieve this alignment.
  87. You can control this alignment by analyzing the
  88. projectfile, lines after
  89. # Control Points: Distance between desired and fitted Position (in Pixels)
  90. This should be less than a pixel, but works up to
  91. 5 pixel. Values of more than 10 pixel indicate
  92. wrong assignments of controlpoints. Large values
  93. may also be due to lens distortions which can be
  94. corrected in the 'i'-line, see 'PTSTitcher'-docs.
  95. Fitting is performed using a multivariable
  96. Levenberg-Marquardt solver.
  97.  
  98. The depth of a point (z-coordinate) can then simply 
  99. be calculated using the equation 
  100.     z = focalLength * Stereobase / [x(0)-x(1)] 
  101. StereoBase is set to 1 and focalLength is calculated
  102. from field of view (v-entry in i-line). 
  103. These coordinates are now relative to the aligned
  104. first image, and are finally transformed back
  105. to the position of the left input image.
  106. Field of view defaults to 50degress, and has
  107. to be set manually in the scripting file. 
  108.  
  109. Accuracy depends on the distance of an object relative
  110. to the stereo base. Distances much larger (eg > 20 times)
  111. or features much smaller than the stereo base are not well
  112. resolved.
  113.  
  114.  
  115.  
  116. Enjoy.
  117.  
  118. Helmut Dersch
  119. der@fh-furtwangen.de
  120.  
  121. -------------------------------------
  122. Spherical Panoramas, Macro Panoramas, 
  123. Free Panorama Software:
  124. <http://www.fh-furtwangen.de/~dersch>
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.